home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / sound / zutil_f2.zip / ZUTIL.MAN < prev   
Text File  |  1993-02-08  |  20KB  |  472 lines
  1. Zutil - ZyXEL Voice Mode Utility
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. --- dieses Programm, in der richtigen Umgebung, ersetzt
  5.     durch das ZyXEL-Modem Anrufbeantworter in weit hoeheren
  6.     Preisklassen ---
  7.  
  8.  
  9. BugFixed Version Zutil_F2 - Fertigstellung am 8. Februar 1993
  10. War in der letzten Release (_F) nicht die Rede von einer
  11. bestandenen Matheklausur ? Jedenfalls veranlasst ein kleiner
  12. Vorzeichenfehler in jener Version, dass alle Versuche, ein
  13. damit aufgezeichnetes File wieder abzuspielen, zum Scheitern
  14. verurteilt sind... Hoffe, die Matheklausur sieht nicht genauso aus...
  15. Sorry an alle, die es schon gezogen haben...
  16.  
  17.  
  18. (c) 1992,1993 Kolja Waschk
  19.  
  20.  
  21. Inhalt
  22. ~~~~~~
  23. 1. Einleitung
  24.         1.1 Voraussetzungen
  25. 2. Allgemeines zum Aufruf
  26. 3. Die Funktionen im einzelnen
  27.    3.1 AWAIT
  28.    3.2 HANGUP
  29.    3.3 PLAY
  30.    3.4 RECORD
  31.    3.5 SEND
  32.    3.6 WATCH
  33. 4. Optionen
  34.    4.1 /Dx - Erzeugen eines Tons vor Aufnahme oder Wiedergabe
  35.    4.2 /Fx - Bestimmen der Tonfrequenz (s.a. /Dx)
  36.    4.3 /I  - Ignorieren des Fax-Calling-Tones
  37.    4.4 /L  - Mikrofon/int. Lautsprecher statt Telefonleitung verwenden
  38.    4.5 /K  - Dateien, die 'totale Stille' enthalten, loeschen
  39.    4.6 /Mx - max. Anzahl zu empfangender DTMF-Codes
  40.    4.7 /Px - Portnr. der seriellen Schnittstelle
  41.    4.8 /Rx - Klingelzeichenzaehler
  42.    4.9 /Sx - Aufzeichnungs/Kompressionsverfahren bestimmen
  43.    4.10 /Tx - Zeitlimit fuer bestimmte Funktionen setzen
  44. 5. Errorlevel
  45.    5.1 durch Fehler oder Faxe hervorgerufene Errorlevel
  46.    5.2 Methode der Uebergabe von DTMF-Code-Sequenzen
  47. 6. FOSSY.COM
  48. 7. Zukunftsplaene
  49.    7.1 known bugs
  50. 8. Thanks
  51.  
  52.  
  53. 1. Einleitung
  54. ~~~~~~~~~~~~~
  55.  
  56. Zur Legalitaet :
  57.  
  58. a) es duerfen keine Aenderungen an ZUTIL.EXE oder diesem Text
  59.    ohne meine Zustimmung vorgenommen werden.
  60. b) die Benutzung dieses Programms ist kostenlos.
  61. c) ZUTIL.EXE und ZUTIL.MAN duerfen bedenkenlos kopiert, weitergegeben,
  62.    in Mailboxen zum Download bereitgestellt und von Haendlern ihren
  63.    ZyXELs beigelegt werden, jedoch nur im Verbund und nur kostenfrei.
  64. d) eine Ausnahme bei dieser Freizuegigkeit bildet die Weitergabe dieses
  65.    Programms durch PD/Shareware-Distributoren, durch Zeitschriften und
  66.    aehnliche Anbieter, die aus der Weitergabe einen finanziellen
  67.    Gewinn erhalten wuerden.
  68.  
  69.  
  70. Ich (der Autor dieses Textes und des Programms selber) bin wie folgt
  71.    zu erreichen :
  72.  
  73.    auf dem Postweg : Kolja Waschk
  74.                      Oevelgoenne 23
  75.                      W-2000 Hamburg 52
  76.                      Deutschland
  77.  
  78.    im FidoNet :      2:241/2101.27 (ab ca. Maerz '93 2:241/2114 oder 2115)
  79.    sonst. e-mail :   koljawk@zerebrm.isnet.sub.org
  80.  
  81.    Telefon (voice)   040-8804056         Zerebellum (Zerebrum TS)
  82.    Telefon (fax)     040-8804056  \_____ 24 Stunden online
  83.    Telefon (mailbox) 040-8804056  /      19.2k/beta ZyXEL U1496E+
  84.  
  85. Fragen, Anregungen und Fehlerberichte bitte ich per e-mail, Netmail
  86. oder Fax zu schicken...
  87.  
  88.  
  89. Dann wollen wir mal.
  90.  
  91. 1.1 Systemvoraussetzungen
  92. ~~~~~~~~~~~~~~~~~~~~~~~~~
  93.  
  94.  - IBM oder kompatibler mit ca. 50k freiem Speicher
  95.    (moeglichst ein schneller AT oder >=386)
  96.  - Fossiltreiber installiert (BNU, X00,...), und _nicht unter_ 38400 bps
  97.    bzw. 19200 bps (fuer reine CELP-Anwendung) gelockt (wenn ueberhaupt)
  98.  - ZyXEL Modem angeschlossen
  99.    (mit Firmware >= 5.00M, MegaBit-Eproms)
  100.    Die beste DTMF-Erkennung bietet zur Zeit die Version 5.05.
  101.  - Festplatte. Zwar koennen Dateien auch von Diskette gelesen werden, jedoch
  102.    ist die Gefahr, dass dafuer zuviel Zeit verbraucht wird waehrend des
  103.    Abspielens, auesserst hoch. Falls hier Probleme vermutet werden, hilft
  104.    vielleicht die Installation eines Cache-Programms (SmartDrv, HyperDisk).
  105.  
  106.  
  107. 2. Allgemeines zum Aufruf
  108. ~~~~~~~~~~~~~~~~~~~~~~~~~
  109.  
  110. Die einzelnen Funktionen werden alle aufgerufen mit
  111.  
  112.    ZUTIL <Funktion> [Optionen] [filename] [strings] [Optionen] [filename] ...
  113.  
  114. <Funktion> steht fuer RECORD, PLAY, AWAIT, SEND, HANGUP, WATCH; die Angabe
  115. des ersten Buchstaben des Funktionsnamens (R,P,A,S,H,W) reicht auch.
  116.  
  117. <Optionen> muessen mit '/' oder '-' beginnen, gefolgt vom Optionsbuchstaben
  118. (s.u.). Direkt hinter dem Optionsbuchstaben, ohne Leerzeichen getrennt,
  119. wird ein eventueller Wert angegeben (z.B. /F440 ).
  120.  
  121. <strings> steht fuer beliebige Zeichenketten. Zeichenketten, die von DOS
  122. interpretierbare Sonderzeichen oder Leerzeichen enthalten, muessen in
  123. Anfuehrungszeichen eingeschlossen werden (z.B. "AT H0|").
  124.  
  125. <filename> stellt auch nur eine Zeichenkette wie oben dar, zugelassen sind
  126. vollstaendige Pfadnamen, Laufwerksbezeichner sowie Wildcards (* und ?),
  127. um den Dateinamen zu ergaenzen.
  128.  
  129. Der erste vorkommende String wird von RECORD und PLAY immer als Filename
  130. gedeutet; SEND interpretiert diesen als zu sendendes Modemkommando.
  131.  
  132. ZUTIL ohne Parameter folgt eine Auflistung aller moeglichen Parameter und
  133. Errorlevels.
  134. Ein Abbruch der Funktionen ist uebrigens zu fast jedem Zeitpunkt mit
  135. Ctrl-C oder ESC moeglich.
  136. Ein komplettes Batchfile kann im Ernstfall meistens mit
  137.  Ctrl-Break Ctrl-C abgebrochen werden.
  138.  
  139. 3. Die Funktionen im einzelnen
  140. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  141.  
  142. 3.1 AWAIT
  143. ~~~~~~~~~
  144. Await dient dazu, auf bestimmte Meldungen des Modems zu warten. Bis zu
  145. drei moegliche Meldungen koennen auf der Kommandozeile spezifiziert werden.
  146. Dabei kann das Pipe-Zeichen ('|') als Platzhalter fuer CR sowie LF benutzt
  147. werden.
  148. Achtung :
  149. Beim Aufruf von AWAIT gehen alle zu diesem Zeitpunkt schon empfangenen
  150. Daten verloren. Um auf Meldungen reagieren zu koennen, die direkt auf
  151. gesendete Befehle folgen, sollte man daher nur SEND benutzen.
  152.  
  153. 3.2 HANGUP
  154. ~~~~~~~~~~
  155. Hangup versucht mit fast allen Mitteln, eine bestehende Verbindung zu
  156. unterbrechen. Es wird jedoch kein Modem-Reset (ATZ o.ae.) durchgefuehrt.
  157.  
  158. 3.3 PLAY
  159. ~~~~~~~~
  160. Mit Play kann ein auf Diskette (ja, funktioniert wirklich !) oder Festplatte
  161. gespeichertes Sprachfile ueber das ZyXEL abgespielt werden.
  162. Auch von ZFAX erzeugte Sprachfiles koennen abgespielt werden.
  163. Dabei wird im "local"-Modus das File ueber den eingebauten Lautsprecher des
  164. Modems ausgegeben, ansonsten ueber die Telefonverbindung. Besteht noch
  165. keine Verbindung, so wird sie zu diesem Zeitpunkt hergestellt.
  166. Im Gegensatz zu anderen erhaeltlichen Programmen achtet ZUTIL darauf, dass
  167. nie mehr Daten, als fuer eine bestimmte Wiedergabedauer noetig, zum ZyXEL
  168. geschickt werden, damit eine jederzeit schnelle Reaktion auf DTMF-Codes
  169. garantiert ist und nicht erst noch auf das Abspielen von im Modem-Wiedergabe-
  170. Buffer befindlichen Bytes gewartet werden muss. Sollte dieses zu unerwartet
  171. vielen Problemen fuehren ("CHRCHRCHRCH" ist z.B. ein bekannter Effekt, der
  172. sich beim Abspielen ergibt...), werde ich diese Eigenart wieder entfernen.
  173. Aber testet bitte aus, ob nicht eher die Aufnahme schiefgelaufen ist !
  174. (z.B. Voicefile zum Testen mit ZFAX abspielen oder so; wenn da derselbe
  175. Fehler auftritt, liegt's an der Aufnahme)
  176.  
  177. 3.4 RECORD
  178. ~~~~~~~~~~
  179. Record ist der kritischte und interessanteste Programmteil. Hiermit kann man
  180. Sprache sowohl von der Telefonleitung als auch von einem an die Line -
  181. Buchse angeschlossenen Mikrofon aufzeichnen und auf Festplatte oder
  182. Diskette abspeichern.
  183.  
  184. Es stehen drei Kompressionsalgorithmen fuer die Sprachdaten zur Verfuegung :
  185. 2-bit ADPCM : sichere Aufzeichnung, 2400 byte/s, jedoch schlechte Qualitaet.
  186. 3-bit ADPCM : stellt etwas hoehere Anforderungen an den Rechner und die
  187.               Kapazitaet des Speichermediums (3600 byte/s), bietet jedoch
  188.               gute Wiedergabequalitaet.
  189. CELP : ist nur auf den Plus-Modellen verfuegbar. Dieser komplizierte
  190.        Algorithmus stellt die geringsten Anforderungen an den Rechner
  191.        (1200 byte/s) und bringt trotzdem im Sprachbereich eine sehr gute
  192.        Qualitaet hervor. Meine Empfehlung fuer Ansagen etc., wenn 3-bit
  193.        ADPCM zuviel Speicherplatz nimmt.
  194. Im CELP Modus verlaeuft zudem die Erkennung von DTMF-Codes sowie die
  195. Silence-Erkennung weitaus zuverlaessiger als in den ADPCM-Modi,
  196. da prinzipiell durch diesen Reduktionsalgorithmus eine grosse Anzahl an
  197. Stoergeraeuschen (50 Hz Brummen auf der Leitung, Hintergrundgeraeusche)
  198. we